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Releasing the power to everyone, 

Control-I(nterface) S(tandards) 

Computers work best in an environment of standards and com patibility, If 
all computers, interface cards, and printers were exactly the same, no one 
would ever have a problem with mysterious line-breaks in the middle of a 
master's thesis. 

On the other hand, if everyone always adhered to standards, and the 
standard for Apple li printers was based on the technology avatlable the day 
the Apple 11 was introduced, we would still be using 72-column, upper-case- 
only teletype printers with our Apples. Printing graphics would be a dream, 
printing in various character widths or proportional type impossible, and no 
one would even consider using a computer to print a master's thesis. 

Progress dooms us to incompatibilities and to knowing far more about 
how computers talk to printers than we really want to know However, if every 
computer and every pri nter spoke a different language, every human a t every 
keyboard would need to be an expert translator to get them to talk to each 
other. To avoid this situation we have standards. The more detailed they are, 
the better. The more discussed they are before they are finalized, the better, 
The more we follow them, the better. 

Better standards are needed in many, many areas of the kingdom. 
This month we're going to examine just one tiny little area in detail to see 
whafs involved. This area is one we've discussed here several times in the 
past— serial and parallel interface "firmware. "This is the stuff your software 
talks to when you tell it to printsomething on your printer or send something 
through your modem. It's built into your serial or parallel interface "cards," if 
you have them, or into your serial "ports" if you're using a 1 Ic or a Hgs. 

There are a number of standards already in effect for serial and parallel 
interface firmware. Some details of these standards have even been 
published clearly and frequently enough for anyone to follow. Other details 
become obvious as one works with interfaces. Other details are neither 
obvious nor published (or have been published murkily), and it is in the 



At the most elemen tary level, the standards that i 
by all devices in Apple II slots are these. Each slot (except "slotO") has 256 
bytes of memory space that can be used for firmware. 'Firmware" consists of 
machine language instructions for the Apple's microprocessor that tell it 
what to do to get the card to work. It's the same thing as "software,'' except 
that if s been permanently written into chips that are built into your interface 
card or computer. 

These 256 bytes, known as the "slot ROM space," appear in the address 
range $CsOO to $CsrT, where "s" is the slot number of the card. For example, 
the 256 bytes for slot 1 are at $C100 to $CUT. (The dollar sign indicates a 
hexadecimal number. Hexadecimal numbers have 16 possible digits that go 
from to 9, followed by A through F. $0000 is the lowest possible four-digit 
hexadecimal number, $FFJT is the highest I'm using them here because 
they're easier to remem ber in this context tha n their decimal equivalents.) 

In addition to the 256 exclusive-use bytes devoted to each slot there are 
2,048 additional bytes, in the address range from SC800 to $CFFF, that all the 
slots can share. This is known as the "expansion ROM space." The usage 
rules for this area are that whenever address $CFFF is used, all cards are to 
turn off their $C800 memory. Whenever an address within a card's 256-byte 
space is used, that card alone is to turn its $C800 memory on. Thus, a card 
that wants to use its own $C800 memory merely heeds to tickle $CFFF and 
JMP to the $C800 space. The JMP instruction itself, which will be in the 256- 
byte space, will turn the card's $C800 space back on after the $CfTF turned it, 
and everyone else's, off. 
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In addition to space for firmware, each slot also has the exclusive use of 16 
bytes for accessing hardware "registers" and "softswitches" and 8 bytes of 
RAM memory for remembering things. 

The 16 hardware bytes, known as "I/O space," appear at $C080+sO to 
$C080+sF, where "s," again, is the slot number. Thus, the I/O space for slot 1 
isat$C09O$C09F. 

The 8 bytes of RAM, which reside in an area known as the "scieenholes" 
(because this RAM is inside the range of memory used by the Apple display 
screen), are at the following addresses- $478+s, $4F8+s, $578+s, $5F8+s, 
$678+s, $6F8+s. $778+s, and $7F8+s, 

These standards have existed since the first Apple II. They are documented 
in detail in each of Apple's technical reference manuals. Even so, one detail of 
even these elementary standards was broken by Apple's own Super Serial 
Card. It is an unintentional bug, but it demonstrates how difficult it is for 
developers to follow standards in every detail, even when fhey want to. More 
on this later, 

One of the first interface cards designed for the Apple 11 was the 

Parallel Printer Interface Card. The firmware for this card, which was written 
by Steve Wozniak in 1977, used only the 256-byte slot ROM space. 

The card was designed to be used with Integer Basic from the Monitor, or 
with assembly language. To turn the card on from Integer Basic, you entered 
the PR#s command (where "s," again, indicates which slot the card is in). This 
command changes a location known as the "output vector" so that when 
anything is PRHiTed, control of the computer will pass to the firmware on the 
card rather than to the built-in "video" firmware. 

After a PR#s, the Apple's microprocessor executes the firstbyte of firmware 
on the card (at SCsOO) the next time something is printed. Wozniak called 
this the "default entry," because starting at this address caused the card to 
reset itself to its "default" settings (it "initialized" itself). While setting the 
defaults, the card also made an additional change to the output vector so 
that succeeding calls to the card would go to byte $Cs02 Wozniak called mis 
the "normal entry." Later, this scheme of passing control to firmware became 
known as the "BASIC Firmware Protocol." 

Acharacter sentto the card was held until the printer was ready to accept it 
Then it was sent to the printer. After that it was sentto the video firmware. The 
card automatically added a "linefeed" (a control character that tells a printer 
to advance the paper one line) after each carriage return. Unlike typewriters. 
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many printers then (and now) used "carriage return" as a signal to move tq. 
the left margin without advancing any paper. Thus, Wozniak's card added 
linefeeds so that what was being printed wouldn't end up all on one line. 

However, some printers then (and now) automatically advanced the paper 
one line when they saw the carriage return signal. These printers would print 
double-spaced with the parallel card (advancing one line because of the 
carriage return and another line because of Wozniak's linefeed) unless mere 
was someway to tell the card not to send linefeeds. 

To accomplish this, Wozniak dedded to make his card watch for an 
"escape character" in the incoming character stream. If the card saw that 
character, it would know that what followed was a command it should 
execute, rather than letters it was supposed to pass on to the printer, the 
escape character the card was taught to watch for was control-l (interface?). 
And a control-I followed by a K laid the card to stop sending (kill?) linefeeds. 

Problem. Control-l is used by some printers as a "tab" command. If the 
interface card thinks each control-I is meant for it (and consequently refuses 
to send it on to the printer), how do you get printer tabs to work? Wozniak 
solved this problem by allowingyou to change the control-I to any other ASCII 
control-character by sending the new escape character right after the old 
one. "Control-I cohtrol-A," for example, changed the escape character to 
control-A. "Control-A control-l," or reinitializing the card (by using FR*s or 
another means to restart at the SCsOO entry point), changed it back again. 

Problem. Lines sent to the printer broke at column 40, just as they did on 
the screen, even though printers could handle wider, lines. In order to get 
longer lines to the printer, it was necessary to turn the video (also known as 
"screen echo") off. The command Wozniak decided to use for this was 
"control-l nN," where the small n was a decimal number that told the card 
where you mould like an automatic carriage return, since column 40 isn't it 
Another command, "control-l 1," or reinitializing the card with Pfl#s, put 
things back like they were— video on with line breaks at column 40. 

Because it was first Wozniak's Parallel Printer Interface Card set a lot of 
standards that have never been officially written down anywhere. But most 
interface cards for the Apple II have honored the "traditions" of Wozniak. 
Examples of these traditions include using eontrol-1 as the escape character, 
having the BASIC entry point of the card change the output vector to a 
"normal entry point;' and using K, nfl, and I as the kill linefeed, turn off video 
and set line width, and turn on video and reset line width commands. 

The next major standard-setting card to appear was Apple's Super 
Serial Card. The firmware for this card was finished in January 1581 There 
were some other serial cards from Apple before the Super Serial Card and 
some short-lived interface-card standards (Pascal 10), but nothing memorable. 

What made the Super Serial Card a big deal was that it was the first card to 
use what Apple calls the "Pascal 11 Firmware Protocol." The name is 
unfortunate. I've gotten on my soapbox before about how important it is for 
engj neers to work as hard on the names they give things as on other aspects 
of a device's design (August 1987, page 2.49-50). The only link between 
Pascal and this interface is that Pascal was the first software to use it 
However, because of the name, most programmers think of it as something 
thafs useful only in a Fascal environment 

Although the two firmware interfaces used on the Apple II are known as 
"the BASIC interface" and "the Pascal interface," and although Applesoft 
uses the BASIC interface and Apple Pascal uses the Pascal interface, 
programs written in assembly language can use either one. With the addition 
of a small assembly language "driver," an Applesoft program can use the 
Pascal interface quite easily, and vice-versa. There is no unbreakable bond 
between the two interfaces and the two languages. (I've heard rumors that 
some Pascal firmware uses some of the same "zero-page" locations as 
Applesoft which would make the firmware incompatible with Applesoft 
programs. I haven't yet found any, however, so I'll appeal to readers who have 
encountered this to let me know the details. ) 

In order to make it as clear as possible that any software can use either 
interface, here in Open-Apple I will refer to the "BASIC Interface" as the 
"Basic Interface" and the "Pascal 11 Interface" as the "Advanced Interface." 

The manual that came with the Super Serial Card documented the 
Advanced Firmware Protocol in great detail. (The Super Serial Card is still in 
production but its manual has been sanitized and no longer contains any of 
this iriformation. nowadays you can find most of the advanced interface 
documentation in the lie and He technical reference manuals and the Ilgs 
firmware manual, but none of these includes all of the details found in the 
1981 Super Serial Card manual.) 

The Advanced Firmware Protocol provides a set of alternate "entry points" 
to the interface card firmware. These entry points provide finer control over 



the card than the basic ($CsOO) entry point There are three separate entry 
points for initializing the firmware, for writing to the device, and for reading 
what the device has sent to the Apple. In addition, a fourth entry point for 
determining the "status" of the device (has it sent us a character? is it ready 
for us to send it another character?), a fifth entry point for controlling the 
firmware, and a sixth entry point for determining whether the firmware's card 
was the source of an interrupt were provided by the standard. Wfe'll see how to 
use these entry points in a moment 

The advanced standard also provides for "device identification." 

Pour bytes areused to identify what a card is used for and whether it supports 
the advanced standard. These bytes are: 

Advanced FirmuarE Device Identification Protocol 

decimal 
address value 



hexadecimal 


address 


ualue 


tCsflS 


136 


$Cs0? 


SIB 




301 


icsec 


fci 



■1915; ♦ (slot*25G) 
49159 + («lot*256] 
491E3 + (slCt*ZSG) 
49164 + [Blot*25E) 



S6 
24 

1 

(device signature byte) 



The fourth of these locations is called the "device signature byte." While I've 
purposefully limited this article to serial and parallel I/O firmware, the 
Advanced Firmware Protocol is available for most Apple II character-oriented 
devices. These incl ude the 80-column screen firmware, the keyboard.and the 
AppleTalk network, as well as serial and parallel cards. Some third-party 
docks, speech and sound cards, and slot-resident modems may also 
support this protocol. (The Apple Ilgs clock and its sound chip, however, are 
accessed through Ilgs Toolbox routines rather than through slot-based 
firmware protocols. This is because there just aren't enough slots available - 
each device requires a separate slot under the basic and advanced firmware 
protocols.) 

Incidentally, the other kind of device you'll find on an Apple II is called a 
block-oriented device. An example is a disk drive. On the Apple II, block- 
oriented devices use a different firmware protocol, known as "Smartport," 
which was described in Open-Apple in January 1987, pages 2.89-93. 

The first hex digit of the Advanced Firmware Protocol's device signature 
byte identifies a device's class. Defined signatures are: 



if» reserved 

$18 printer 

$20 mouse or joystick 

£30 serial or parallel I/D 

140 modem 

S50 sound/speech 



$60 clock 
$70 mass storaga 
$80 80-coluirin card 
$98 netuark pr bus interface 
$W othsr [none af the abouej 
$60-$F0 rsseruBd 



The second hex digit is a "unique identifier for the card, assigned by Apple 
Technical Support," according to the original Super Serial Card manual 
(page 51). According to the technical reference manual for the He, It is a 
"unique identl Her for the card, used by some manufacturers for their cards" 
(page 144). According to the lie technical manual, it is "an identifier (not 
necessarily unique)" (page 67). 

The Super Serial Card's definition for this byte was a nice try, but obviously 
the standard didn't allow for enough possible combinations— there have 
been far more than 16 manufacturers of "serial or parallel I/O" cards during 
the history of the Apple II. The lie manual's comment reflects the truth of the 
situation today. 

According to the Super Serial Card manual, byte $CsPF is to hold the 
"firmware revision-level" ( page 57 ). On the Super Serial Card, this byte holds 
an $08. Apple has never revised the Super Serial Card firmware, so this is the 
only value you'l I find here on a true Super Serial Card. 

However, Apple has produced several Super Serial Card clones. One was 
built into the original He, one into the 3.5 He (the He that supports 3.5 inch 
disk drives), and one into the Ilgs. (Actually, there are two Super Serial Card 
clones built into each lie and Ilgs, one connected to port 1 and one 
connected to port 2.) 

According to the Advanced Firmware Device Identification Protocol, each 
of these is a Super Serial Card, although, as we shaR see later, there are many 
subtle (and not so subtle) differences between the four versions. One of the 
subtle differences is that Apple's He programmers forgot about the firmware 
revision-level byte at $CsFF — both versions of the lie have a $00 in that byte. 
On the Ilgs, on the other hand, a new Ilgs protocol makes version numbers 
two bytes long (but there's a bit of confusion among Apple's engineers about 
how to implement them— see "Machine code version numbers" in this 
month's letters section). The original Ilgs ROMs have $00 $10 at $C1FMF 
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and at $C2FE-FF. This should be taken to mean version 10. The new Has 
ROMs have $10 $10 (version U ) at both locations. (A few bugs were fixed in 
the serial firmware in the newer Hgs ROMs. The bugs had to do with status 
calls, Applesoft tabbing, and buffering problems when baud, data format or 
parity were changed with buffering enabled.) 

To my knowledge, Apple has never defined a way to tell its four (five if you 
count both Hgs versions) "Super Serial Cards" apart. For most programmers 
this is only part of the problem, as many other companies have developed 
serial and parallel I/O devices that are subtly (or grossly) different from the 
Super Serial Card "standard." Until I hear of something better, F suggest you 
use the following "signatures" for identifying serial and parallel I/O cards that 
follow the advanced protocol; 

5ignn'_-65 identifying specific Eerial/parallal -\-Tuare 

fi) ICe85=I3B; ICs07=HB; SCs8B=*81; ICe0CsI3x ■(* can be anything) 

1 

B) sCs0D-sCsl3 ICeFE-ff 

8E 94 3? 9fl 85 27 BE 



More? SCsll 

if value at SCsll=0, then foilcumg commands are also supported: 



Super Serial Card 

Tic (original, port 1) 

lie (original, port 2) 

He (3.5 ROMs, port 1) 

lie t . port 2) 

Hgs (1.8 ROM. ports 112) 

Hgs (1.1 HOM, ports 112) 



E4 EE F6 FB OA P.2 CI 

11 13 15 17 00 01 80 

9E FB B4 BB DP P2 CI 

11 13 15 17 B» B8 80 

45 IB 47 48 00 14 M 
45 4E 47 40 00 14 00 



CS 0B 



m 10 

10 10 



Obviously, it doesn 't take al I eight bytes to tell Apple's versions of the Super 
Serial Card apart but using all eight should allow us to tell any serial or 
parallel I/O card from any other. (Send us the values you find in these bytes 
on your own third-party I/O cards and well document them in a future issue. 
To avoid transcription errors, turn on your printer, enter the Monitor (CALL ■ 
151), and type CsOO.Cs 13— replacing the "s" with (he slot number of your 
card— and then CsFE.CsFF. Then type in everything you know about the type 
of card, manufacturer, and version number and send us the piece of paper. ) 




Once you've confirmed that a card follows the advanced protocol, 
if s easy to use the advanced interface from assembly language. The 

area at $CsOD-$Csl3 that we just used for a firmware "signature" is actually a 
table of entry point addresses. For example, the value at $CsOD tells you the 
entry point for the initialization routine. Looking at our table of signatures, 
youll see that the value in $CsOD on the Super Serial Card is $8E. 
Consequently, the place to go to initialize that card, using its advanced 
firmware, is $Cs8E. On the Hgs, on the other hand, the initialization routine 
starts at $Cs45, as can be seen in the signature (entry point table) for that 
machine. 

When call ing the advanced firm ware, you pass information to it (such as a 
character you want sent to your printer) in the microprocessor's registers. It 
passes information back (such as a character that came in over your 
modem) the same way. The following table shows which offset to use in the 
table of entry point addresses and what is passed in the registers for each 
advanced firmware function: 

Advanced Firmware Entry Point Protocol 



cad offset 


fl reg 


X reg 


Y rag 


carry 


Inl t JC90O 










on entry 




SCs 


isB 




on exit 




error code 






Head ICS0E 










on entry 




Kb 


Ss0 




on exit 


Cher read 


error code 






Write SCsBF 










on Entry 


char to urite SCs 


Ss0 




□n exit 




error code 






Status ICslO 










rsady for output' 








Dn entry 


-a 


SCs 


IS0 




on exit 




error code 




0=N 1=Y 


has; a character been received? 






on entry 




ICe 






an exit 




error code 




e=N i=y 



Control JCsl2 
House 

on entry /node crrd $Cs 
on exit — error code 

Hgs "extended interface" 

end list adr lou byte hi byte 
on exit 

lntrupt SCsl3 
Mousei 

on antry 
on exit 



»S0 



bank 



terror 



0=Y 1=N 



If you are writing firmware that includes the advancedinterface,you should 
attempt to bring the A and Y registers back unchanged. If you are writing 
software that uses the advanced interface, you should assume that those 
registers come back looking ransacked. This maximizes the compatibility of 
your firmware with other people's programs and viceversa. 

If you are writing firmware that includes the advanced Interface, you should 
he very conservative in your use of zero-page memory The advanced 
interface on the Super Serial Card uses only byte $26 (for remembering $s0 ), 
byte $27 (for remembering the input/outoutcharacter), and bytes $2A, $2B, 
and $35 (for temporary manipulations). None of these locations conflict with 
Applesoft per se, although $26 and $27 are also used by Monitor routines 
that display low-resolution graphics. The basic interface on the Super Serial 
Card uses several additional zero-page locations to exchange information 
with the Monitor-byte $24 (Cfl), $28-$29 (BASL), $36-$37 (output hook), 
$38-$39 (input hook), and $4E-J4F (random number seed). 

Earlier in this article I mentioned that the Super Serial Card fails to 
follow one of the details of the protocol for slot-based devices. That 
detail is that the advanced interface does not tickle $CFFF before jumping to 
ro utines in the expansion ROM space at $C800.This went unnoticed foryears 
because the Super Serial Card was able to overpower other cards that still 
had their expansion ROMs turned on. With the appearance of the 3.5 disk 
controller, however, the bug was revealed. Because of this, It is necessary to 
tickle $CFFFyourself just before you use the advanced firmware on the Super 
Serial Card (and it doesn't hurt to tickle it before using other cards as well). 

Another subtle problem arises because the original protocol for slot-based 
devices has been slightly enhanced in the last few years, but news of this 
enhancement never made it into the manuals or into the firmware that had 
already been written. This enhancement is that any card that turns on its 
expansion ROM space should store its slot number (in the form $Cs) in the 
screenhole byte at $7F8 (known as MSLOT) before turning on the expansion 
ROM. This is so that the operating system can know who owns the expansion 
ROM space when an interrupt occurs. (As a result of an interrupt, the 
operating system may have to use another card's expansion ROM; it must 
then turn the executing program's ROM back on before returning from the 
interrupt or the system will have a stroke and die.) 

The Super Serial Card does use MSLOT, but not until afterit is executing in 
the expansion ROM, so there is always a brief interval when an interrupt could 
cause a fatal hemorrhage. 

As a result programmers should be careful to take the following steps: 

softuare authors: 

Just bsfore calling the advanced Interface, do sDnething like this: 
LDfl «?? character out or status request number 
LOX slot.number in the form ICs 
LDY slot.nuiibtr In ths form is0 
STX 17F0 (MSLOT) 
5TX iCFFF 
JMP (entry. point) 

finnuare authors: 

if you use the expansion ROM, execute the following instructions 
In the slot BON space beFure jumping to »CB00 or beyond: 
5TX »7Fa [MSLDT) 
5TX ICFFF 

I'll include a longer assembly language example of how to use the 
advanced firmware interface next month (or so). 

In addition to problems with $CFFF and MSLOT, several details of the 
Advanced Firmware Protocol were neglected in the Super Serial Card 
manual. As a consequence, those details are not handled consistently by 
Apple 11 firmware and their value has been lost 
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One missing detail was a list of possible error codes that could be 
returned in the X register. 1 scanned pages and pages of Apple documen- 
tation and found only one reference to this value. That was in the description 
of the Apple video firmware in the 11c technical reference manual (page 110), 
It says that if the value in the A register is no t $00 or $01 for a Status call the 
interface "returns with a 3 in the X register (lOResult ILLEGAL OPERATION); 
otherwise it returns with a in the X register (IOResult=GOOD)," 

The term lOResult smelled of Pascal, so I asked Dennis to see if he could 
find anything pertinenttotheXregister in Apple's Pascal documentation. He 
succeeded. "All drivers must pass back a completion code in the X register 
corresponding to the fable on page 280 of the 11 Apple // Apple Pascaf 
Operating System Reference Manual," according to a little ditty called the 
"ATTACH-BIOS document for Apple II Pascal IX" dated January 12, 1980. The 
table of completion results lists 18 codes, all of which are disk errors except 
for $00, no error; $03, illegal operation; and $40, device error. 




However, after studying the actual source code of the Super Serial Card 
Firmware (jfs in the original manual), I discovered that it can return 16 
additional X register error codes (between $20 and $2F) not mentioned in 
either the Pascal or Super Serial Card manuals. The Read call and the has-a- 
character-been-received Status call come back with a byte that looks like 



Meaning of Super Serial Card X Register Errors, by hit 
e c o f p 

e is an overall error indicator; if e=l at least one other bit also = 1 
if c-1 the carrier uas lost Curing the last receive oparatlon 
if 0=1 (overrun) the ftppls isn't collecting data fist enough 
if f*l (framing) not enough stop bite uere raceiued 
if p=d a parity error occurred 

On the Super Serial Card, the Init call, the IMite call, and the are-you-ready- 
to-send Status call, on the other hand, always come back with a zero, or "no 
error," in the Xregister. The ILLEGAL OPERATION error talked about in the lie 
manual isn't supported {if you give the Super Serial Card an odd number in 
the A register on a Status call, it assumes you sent a one; if you give itan eueri 
number, it assumes you sent a zero). 

Because of poor initial documentation of this aspect of the advanced 
firmware protocol, all of its value has been lost I doubt there are halfa-dozen 
commercial programs that even look at the X register after making an 
advanced interface call. Even Apple's own Super Serial Card clones on the He 
and the figs don't follow the X register aspect of the original Super Serial 
Card. They support only the error on Status calls. All other functions return a 
zero in the X register. Interestingly, on bad status calls the He and Jigs serial 
ports return the $40 DEVICE ERROR code, rather than the $03 ILLEGAL 
OPERATION code that the video firmware returns for this mistake. 

Apple's mouse card, which appears to support the advanced firmware 
interface, returns the $03 ILLEGAL OPERATION code in the Xregister for any 
Init, Read, Write, or Status call. These calls do nothing to the mouse, which is 
actually controlled by a number of other firmware entry points. 

Even in the face of all these differences, I recommend that programmers 
using the advanced interface check the X register for errors, particularly on 
Init calls. If a non-zero value is returned by an Init call you should treat the 
interface as unusable. 

Other missing details in the Super Serial Card documentation bad 
to do with the Control and Interrupt functions of the advanced 
interface. The original Super Serial Card Manual only said that if byte SCslL 
was zero, two optional en try points followed— the first for a "control routine" 
and the second for an "interrupt handling routine." Because of the lack of 
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documentation, there is no uniformity whatsoever in how devices use these 
entry points, 

There are three devices 1 know of that use at least one of these functions. 
One is the Appletalk firmware built into the Apple Hgs. It has an offset for the 
Control function, but it has a zero in the offset for the interrupt function 
(which has to mean there's nothing there— if you called that address you'd go 
to $Cs00, the basic entry point). Apple's Hgs firmware documentation 
doesn't even smile in Appletalk's direction, so I have have no idea what the 
Appletalk Control function does or how it worits. 

The second device that uses the control entry point is Apple's mouse. The 
mouse is controlled by nine routines that can be found by looking in an offset 
table just like the one that the advanced firmware interface has. The first two 
bytes of this table purposefully overlap the Control and Interrupt offsets of 
the advanced firmware interface. The Control offset points to a routine called 
Setmouse, which turns the mouse hardware on and off and telfs it what kinds 
of interrupts it should generate. (This offset is not to be confused with 
Initmouse, which sets defaults and synchronizes mouse interrupts with the 
video's vertical blanking interval and which, for reasons unknown, does not 
use the Init entry point) 

The Interrupt offset points to a routine called Servemouse, which puts a 
zero in the microprocessor's "cany" bit if the mouse has generated an 
interrupt signal. An interrupt signal is kind of like a scream in the night It tells 
the microprocessor to immediately stop what ifs doing and go to the aid of a 
device But the only way the operating system can figure out where the scream 
came from is to knock on the door of every device connected to the computer 
until it finds one whimpering for attention. The Servemouse routine provides 
an easy way for interrupt firmware to figure out if it's the mouse that/s 
squeaking ■ 

The third device that uses the control entry point is the serial firmware on 
the Apple Hgs. like Appletalk, this firmware has $00 in the interrupt entry 
point 

The control entry point in the Hgs serial firmware uses a completely new 
scheme for passing data. Rather than using the registers for data, as in all 
other advanced firmware calls, the Hgs serial firmware uses the registers to 
pass a pointer to the data. The low byte of this pointer goes in the A register, 
the "high" byte in the X register, and the bank number in the Y register. 
(Although the data for the command can be placed anywhere in llgs memory, 
the microprocessor should be in 6502 mode when you actually pass control 
to the entry point This is always the case when using either the basic or the 
advanced firmware interface.) 

Your pointer is aimed at a "command list" The shortest command list 
currently in use has four bytes, the longest ten. Each command list begins 
with a one-byte parameter count a one-byte command, and a two-byte space 
for an error code to be returned, Bytes after those four are used by the 
firmware to pass information to you, or by you to pass information to the 
firmware. 

Two of the supported commands are for "mode" control, nine are for buffer 
control (the llgs serial ports can buffer both incoming and outgoing data and 
can do printer buffering), and seven are for hardware control. It's best to avoid 
the hardware control commands unless absolutely necessary, since they will 
change on any future Apple II that uses a serial interface chip different from 
the one in the llgs. 

One of the mode control commands, called GetModeBits, is for inquiring 
about how a port is currently set up and the other, called SetModeBits, is for 
making changes. Both have a parameter count of 3. The command code for 
GetModeBits is and for SetModeBits 1 Each uses an additional four bytes 
for the "mode bit image." Thus, the command tables for these commands 
look like this: 

GetModsBits SEtPtadeBite 

W3 parameter count 103 

m crnaand J01 

100 sae result coda J08 

We J0B tW mode bit image J00 S00 »00 J00 

The possible result codes currently supported, which you'll find in the first 
of the result code bytes, are $00, no error; $01 bad call; and $02, bad 
parameter count 

The mode bit image controls such firmware functions as whether to add a 
linefeed after carriage returns, whether to echo characters to the screen, and 
other functions that can also be controlled with escape-character commands. 

Next month we'll look at the llgs mode-bit image, and at the subtle 
differences between escape-character commands on Apple's various Super 
Serial Cards, in detail. 
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Apple's John ScuBey is interviewed in the September 
Playboy (page 51). ScuHey's comments are extremely 
interesting, particularly his remarks about Apple as a 
"third-waue" company, tie says he regards himself 
as the company's "Chief Listener." Apple is unlike the 
typical American company, where decisions are 
Imposed from the top, Sculley says, and unlike the 
traditional Japanese company, where ideas must 
move up a hierarchy in a consensus-building process. 
At Apple, according to Sculley, "ideas can occur 
anywhere in the organization .... top management Is 
not predetermining company strategies." Add this 
interview to your reading list. 

It's pencil time, again. According to a letter Apple 
sent to educators, Hgs units thathaue serial numbers 
beginning with the three digits 705 through 724 
need new ROMs, but not new video chips (September, 
front page, second paragraph). In addition, we have 
now heard reports of some copy-protected software 
not working with the new Hgs ROMs because of 
illegal monkeying around by the copy protection 
scheme, Whenbuylngsoftwareforthellgs, insist on 
un-protected products. 

The lady who owns the phone number we gave at 
the end of last month's Printrix review "is pretty 
upset and claims she is receiving hundreds of calls," 
according to the people at Data TYansforms, whose 
phone number ends with 1301 not 2502 (page 3.61), 

The first letter published below points out an error 
in the next to the last paragraph of my answer to 
"Hgs programming subtleties," in last month's issue, 
page 3.61-62. 

Back in our August issue, at (he very bottom of the 
very iast page, we printed a patch to increase the size 
of the Apple Works catalog buffer (page 2.56). ItreaUy 
does allow you to cataiog subdirectories with more 
than 85 files in them. However, one of our testing 
laboratories has discovered that it also prevents you 
from loading any of them (ouch!). Put a big X over 
that patch and write "doesn't work" next to it For a 
patch that does work, send us three good reasons to 
have more than 85 files ina singie subdirectory (aLso 
inciude theboxtopfrom our September issue and a 
stamped, self-addressed shipping pailet). 

Finally, go way back to our November 1385 
Special Printer Issue and turn to page 185. Replace 
the second through the last paragraphs of the 
section called "The data format," with the following 
(you'll have to write reatsmall): 

wire is kept Oft (or I or MARK) when no characters 
are being sent A sudden transition to OFF (or 0, or 
SPACE) is called a start bit and indicates to the 
receding deuice that a cha meter is coming. After the 
start bit come five to eight data bits, represented by 
MARK or SPACE voltage levels. 



After the data bits, sometimes, is a parity bit. The 
parity bit Is an optional extra bit. Parity bits, if used, 
can be odd, even, MARK, or SPACE. MARK parity 
means the parity bit is always 1 5Fj4CE parity means 
it Is always 0. Odd and even parity mean the trans- 
mitting device sets the parity bit to 1 or in such a 
way that the total number of 1 bits in the data, 
including the parity bit Itself, will be either odd or 
even. Parity can be used for error checking, but 
rarely is. in most Apple H applications, parity is set to 
"none," which means no parity bit is sent. 

After the parity bit, the signal on the voire goes 
back to Off in preparation for the start of the next 
character. This part of the signal is said to consist of 
one or more atop bits. 

When no characters are being transmitted, the 
serialline is keptOtt, or full of stop bits. Under the RS- 
252 standard, there is no requirement that characters 
must appear at equal intervals. While thestart data, 
and parity bits all are represented by a certain 
uoitage ieue! for a certain time period (the faster the 
baud rate, the shorter the time period), stop "bits" 
consist of a certain uoitage feuei for an uncertain time 
period. For example, if your computer Is sending out 
characters at a rate siightlu stoker than the baud 
capacity of the interface, extra stop "bits"— even 
fractional "bits '—can appear between characters. 
This ability to support a uariable time tnteruai between 
characters earns the RS-232 interface the adjectiue 
asynchronous. 

The term data format defines how many data bits 
each character will have, whether the character will 
include a parity bit (and if so, what kind of parity), 
and the minimum number of stop bits between each 
character. This minimum number is typically either 
1 1-1/2, or 2. For signalling purposes, one stop bit is 
enough — when extra stop bits for parts of stop b(£sj 
are Inserted it's either to give the receiving device 
more time to process each character coming in orit's 
an attempt to solve timing problems in the sending 
device. 

For example, the default format of the .Apple 1/c's 
printer port is 8 data bits, no parity bits, and 2 stop 
bits (or "8!i2"). Every other Apple serial device 
defaults to 8!il A printer expecting just one stop bit 
can receiue data from a deuice sending two stop bits 
with no difficulty— it just thinks the engine in the 
sendingdevice isn't operating on ati eight cyiinders. 
The additional stop bit from the sender slows things 
down slightly. This is apparently exactly what was 
expected from the 2 stop bits on the He's port, 
because the serial ports on early models of the lie 
marched to the beat of a hasty drummer (see June 
1985, page 147). 

There are some nasty remarks about printer 

keep, but die rest is a reflection of my confusion. Boy 
it feels good to finally understand how serial com- 
munication works! My thanks go to chapter 11 "The 
Serial interface Ports," of Gary IMe's Inside the 
Apple lie 

TLShutDown does too 

On page 3.62 of your September 1987 issue you 
say that the Hgs toolbox command TLShutDown 
does nothingat present, not true! Under ProDOS 16, 
TLShutDown calls the Boo tl ait functions of all installed 
tools and unloads RAM-based tools (disconnects 
them from the tool table and leaves their memory 
purgable). 

Incidentally, regarding the $400-byte stack/direct 



page block you mentioned in your response to the 
same letter, there is no reason that a direct "page" 
must be limited to 236 bytes on the Jigs. While some 
addressing modes allow access to only the first 256 
bytes of a direct page, indexing from the direct page 
with a 16-bit X or Y register allows you to access all of 
bank 0. The actual allocation of the $400 bytes is up 
to the application; if no direct page is needed, the 
whole $400 can be used for a stack; if a different stack 
area is being used, the whole $400 can be used for 
direct-page storage. 

David A Lyons 
north Liberty, Iowa 

Machine code version numbers 

Are you sure that line 500 of your Smartport reader 
program in the January 19B7 issue is correct (page 
2.92)? The line reads 500 : : VERS = PEEK(807) + 
PEEK(808)*256. 

When 1 run the program, I get version 4096 for my 
UniDisk 3.5. This seems high for the version number 
of a year-old device. Even if the PEEKs are reversed, a 
result of 16 would still be a little high. 

Robert J. Schack 
flew York, rl.Y 

1 noticed the weird version number results when I 
wrote the Smartport article, but didn't know what to 
do about them. Apple's Smartport documentation 
said only that those two bytes were the version 
number, but gave no information about how to 
interpret them. 

Recently ! ran across (he folioioing paragraph on 
page 28 of Michael Fischer's Apple Ugs Technical 
Reference from Osbom McGraw-Hill It refers to 
toolbox version numbers, not firmware versions 
numbers, but is still enlightening-. 

'Version numbers for each tool consist of a word 
value. Bits 0-7 of the word contain the minor revision 
number, beginning with zero. Bits 8-14 contain the 
major revision number, beginning with one. Bit 15 is 
set if the version is a prototype and is clear if the 
version is a released version Thus $90 is version 1 
prototype, $12 is uersion 12 official release, and so 
on." 

Notice that Fischer's description and his tramples, 
which he no doubt got from some Apple documenta- 
tion somewhere, don't match. According to his 
description, "uersion 10 prototype" should be $8100. 
"Vferaton 12 official release" should be $0102. 

If we throw away the low byte of the Smartport 
version number and decipher the high byte as in 
Fischer's examples, we get the results we expect, 
version 10. Thus, to get January's Smartport program 
to report the UniDisk version number "correctly," we 
should change lines 500 and 600 to; 

See : : VERS! = 5THi(lN7(P£EK(Ba8)/l6) + *.* + 
STRilPEEK[B8B) - VftL(VEHS* J«1S) 

eee change VERS to VERS! 

But 1 suspect Fischer's description is really the 
way version numbers are supposed to be used on 
the llgs (otherwise, why use two bytes and then 
throw one away?), in. which case the "correct" 
corrections to the Smartport program would be: 

568 : : VERS* = STSS(PEEK{B0B) ) + -.- + 
STRI(PEEK(8G7) ) 

600 changB VERS to VERSI 

This, of course, returns a uersion number of 16.0 
for the UniDisk, which reflects a certain amount of 
confusion at Apple about uersion number protocol. 
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WhatPR#andlN#do 

Please explain why PR#3 and 1M*3 turn on my 80- 
column card at different times when I replace one 
with the other in my STARTUP program. In immediate 
mode both PR#3 and IfTO turn on the 80-column 
card immediately. 

Dave Uherka 
Grand Forks, ND 

While common Knowledge is that PR#3 "turns on 
80-columns," in fact things are more compter than 
that. JWiat PR*3 and //TO really do is "redirect" 
output or input to slot 3. The "80-ooiumn firmware" 
lives in siot3. However, you ux>ntsee an 80-column 
display untilyou either PRINT something (after PR*) 
or ask for some INPUT (after IN*). In immediate 
mode, Applesoft immediateiy prints something (a)) 
and thereafter asks you to input another command, 
right after you type in either PR*3 or 1W3. Thus, 
either PR#3 or 1N#5 appears to take effect immedi- 
ately. To get the same effect in your programs, you 
must put a PRINT statement right after your PRINT 
Ct1K${4)rPK#r or on INPUT statement rfghi after 
your PRINT Cf1R$(4);"lN#3". 

For a much more detailed description of how this 
umks, see Chapter 12 of the DOStalk Scrapboak, 
"Now the System Operates, " pages 81-91 

Disassembly lines 

Does your remarkable ability (to me) to crack 
object code without any available source code stem 
from long experience or could you illustrate howyou 
doit? 

Are the colons you sometimes use after a line 
number in Applesoft program listings for indentation 
purposes? 

I'm not sure I understand the equivalence of port 1 
on the llgs and the Super Serial Can). Can a "Super 
Serial Card" choice be used for configuring older 
programs? if it can, I presume Slot 1 should not be 
used. Similarly, if slot 3 is the eighty-column pathway, 
can it be used for a MIDI card? 

Herbert M. Olnick 
Mineral Bluff, Ga. 

It takes some experience to get good at disassem- 
bling machine language instructions, but there area 
few tricks of the trade I can describe here, first you 
need a disassembler. This a piece of software that 
scans the ualues in a series of bytes and tells you 
what they mean in assembly language. There is a 
rudimentary disassembler built into every Apple li- 
the Monitor's L(lst) command. More aduanced disas- 
semblers, which are available from most of the 
companies that sell assemblers, wilt send the disas- 
sembly to a file (rather than simply to the screen or a 
printer), will create lists of the addresses referenced, 
and mil even plug in the names of built-in Apple 11 
subroutines, softswitches, and zero-page locations 
where it appears they are being used. 

in most disassemblies you aren't concerned about 
how the whole program worlcs but just want to find a 
sped/icarea that's troubling you to fix it. You find the 
area by scanning through the program looking /or 
embedded text messages, for accesses to certain 
softswitches, zero-page locations, or Monitor sub- 
routines. You can also figure out a lot by looking for 
ProDOS Mil calls (JSR $BF0Q) and, on the llgs, 
toolbOxcalls(JSL$E10000). 

If this doesn't work, or if you really want to 
disassemble the whole program, your next step is to 
load the disassembly into a good word processor 



and start chinkingaway. Whenever you find something 
you can identify— be it a zero-page location, a 
subroutine, a message, or whatever— use the search 
and replace capabilities of the word processor to 
change all references to that address to a name that 
makes sense. As you proceed, the search and replace 
procedure keeps adding clues to parts of the program 
that originally made no sense at ait. Gradually you 
figure everything out (usually finding lots of tittle 
bugs and undocumented features of the program 
along the way}. The experience is very much like 
working on a giant jigsaw puzzle. 

The biggest disassembly 1 ever did was the portion 
of DOS 3.3 from $9D00 to $B8O0 (the command 
interpreter and the file manager). This is about 7,000 
bytes of code. I had a copy of Beneath Apple DOS at 
my side thatl usedasa hint book. It tooksix uieetes of 
daily work. When [was finished I knew enough about 
DOS, its features, and its bugs to write PmntoDOS. 
So/taffc's "DOSfalfc" column, and the DOStalk 
Scrapbook. 

1 think you'll find that many of the best assembly 
language programmers spend a lot of time disas- 
sembling other people's work, just as the best 
writers spend a lot of time reading other people's 
work. Of course, youdon'treaily need to disassemble 
anything to "read" other people's work. Lots of 
assembly language source code is around, particularly 
in Apple's technical manuals. Apple has a tradition of 
publishing the source code to at least the Monitor in 
all of its computer-specific technical references. 

As you do more and more of this, you'll find that 
different programmers have very different stytes. 
Some are ultra-organized. They have a ptace for 
everything, everything in its place, and don't give a 
beep how long it takes to execute. The DOS 3.3 pie 
manager is a good example of this kind of program- 
ming. Others write code that is extremely fast, 
efficient sensible, and elegant Look at anything by 
Steve Wozniak (the original Apple II Monitor, DOS 
5SsR\VTS routines) or Paul Lutus (Apple Writer) for 
examples. Others write code that is impossibly 
complicated, confused, crude, and full of bugs (the 
unknown author of DOS 3.3 s APPEND patch, for 
example). 

If any of this interests you, 1 suggest you get a 
copy of Don Lancaster's Enhancing Your Apple U, 
Vol l ($15.50, Synergetics, Box 809, Thatcher AZ 
85552 602-428-4073). Chapter 3 of that book is 
called Tearing into Machine-Language Code" and is 
worth the price of admission. Lancaster demonstrates 
what he calls the tearing method" of disassembly. 
This method is paper-based and gives you a better 
view of a program's "big picture" than my word- 
processor method. On the other hand, 1 end up with 
completely commented source code in a file that I 
can modify and run through an assembler without 
any additional typing. 

1 use extra colons in Applesoft listings simply to 
make it clear what lines are inside loops. Tmsurprised 
that none of our readers has ever complained that 
Open-Apple's program listings don't look like the 
ones Applesoft itself puts on your screen. Back in the 
early days of the Apple 11 this was a big issue in the 
letters-tc-the-editor pages of Apple II magazines. I 
guess it means you've alt figured out that the 
program listings in Open-Apple are designed more 
for easy reading and understanding than for easy 
typing or speedy execution. 

The "firmware" In port 1 of the llgs is functionally 
equivalent to a Super Serial Card but the "hardware" 
is not. Thus, whether a "Super Serial Card" configu- 



ration will work for any particular program depends 
on whether the program accesses only the firmware 
or whether it also tries to access the hardware. 
Unfortunately, few programs document this kind of 
stuff; your only recourse is to try it and see what 
happens. If a program won't work through the built- 
in port you can have a Super Serial Card In slot I 
change the slot 1 configuration via the control panel 
from "printer port" to "your card," press open-apple/ 
control/reset, and use the Super Serial Card. Using 
this technique, you can switch back and forth as 
often as like without turning the computer off (turn it 
off to insert the card in the first ptace, however, and to 
change cable connections). 

Slot 3 can be used in this same way, however, 
whenever you set slot 3 to "your card "you lose the 
ability to use Apple's 80-column firmware, which will 
prevent many programs from working correctly. 
Bui for example, if your music software doesn't use 
Apple's 80-column firmware, a MID! card might be a 
good choice for that slot. You would have to enter the 
control panel change the slot 3 assignment, and 
reboot before and after running your m usic software, 
but you umuldn't have to give up some other slot 

Apple makes family grumpy 

We Jusl moved into a new house that has the TV 
antenna directly a bove my He. When the Apple is on, it 
causes video interference on channels 4 and 5. 

Everything is grounded...! checked that on the 
suggestion of our local dealer's service person. Ho 
one locally can come up with a solution. As a result, 
my family gets grumpy if I use the computer when 
they're watching NBC or CBS. Telling them PBS is 
good for them hasn't helped, Do you have any hints? 

Fred Olio 
San Antonio, Texas 

/ hanen'f any hints. Somebody somewhere has 
probably figured this our, however. Let's hope they 
write us. 

Logo llgs 

In response to "Go, Logo, Go," in your September 
issue, there is one version of Logo for the Apple that 
has already been altered to take advantage of the llgs 
environment That is Logo //, an upgrade of Apple 
Logo //, available from Logo Computer Systems Inc 
121 Mount Vernon St, Boston, MA 02108 800-321- 
5646 617-742-2990. Several purchase options are 
available, including single copies, lab packs, and site 
licenses. 

Your readers who are interested in Logo might like 
to join the Logo Exchange. We're a group of educators 
interested in the use of Logo. Membership includes a 
subscription to our magazine. Queries can be sent to 
the Logo Exchange, ICCE, University of Oregon, 1787 
Agate St Eugene OR 97403 503-6864414. A year's 
subscription is $2455 for VS. ICCE members, $5 
additional for non-members, and $5 additional for 
international subscriptions. 

Tom Lough 
Charlottesville, Va. 

Hard feelings 

The llgs chip upgrade you mention in your Septem- 
ber issue is interesting. Apple Canada prides itself on 
being a separate entity from its mother company and 
seems also to pride itself on always being a month or 
two behind new developments "south of the border." 
In this age of lightning-fast communications, this 
attitude causes a great deal of hard feelings. As of 
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September 1 Apple Canada had no chip upgrade 
policy. I'd be curious to know if a similar situation 
easts in other countries. 

Lome Walton 
Maple Ridge, BC 

LaserWriter possibilities 

I just purchased a LaserWriter Plus to go along with 
my llgs. Despite what Apple says, you can get Apple 
Witer 2 J to print to the LaserWriterjust fine. You need 
Don Lancaster's patch to Apple miter that allows the 
program to use the new serial ports (see "The great 
Tinaja Quest" in May 1987, page 3.31). Then connect 
vour llgs to the LaserWriter via port 1 with a llgs 
Adapter Cable ("A9M0333, $29.95 retail) and a 
DB25-male to DB25-male straight-through cable 
(approximately $20 retail). 

You need the second cable because the adapter 
cable is less than a foot long. Don't use a null-modem 
cable; a straight-through cable works just fine. Make 
sure the LaserWriter is off and set the back panel 
switch to "SPECIAL." This tells the LaserWriter to 
emulate a Diablo 630 printer. Turn your LaserWriter 
on, let it warm up, and run Apple HYiteras usual. The 
Control Panel slot assignment for slot 1 should be 
directed to the printer port With this setup I've been 
able to print anything Apple Writer can do. including 
this letter. 

Ifnder this configuration, your LaserWriter is a very 
expensive Diablo printer; you can't reach the many 
special fonts, etc. To do PostScript processing, you 
can use the same cable and set the LaserWriter back 
panel switch to "9600". Then you need software to 
send the necessary PostScript commands. You can 
also connect the llgs (or a ! le) to the LaserWriter via a 
Super Serial Card and the appropriate cable. Or you 
can connect the llgs via AppleTalk. 

I can't get Apple Wfriter to work with the LaserWriter 
via AppleTalk; why, I don't know. Is there any source 
mat disassembles and describes the AppleTalk 
interface in the llgs? AppleWorks does work with a 
LaserWriter via AppleTalk as advertised, in which case 
your LaserWriter is a very expensive ImageWriter. 

Other programs will print to a LaserWriter connected 
to port 1 (or 2) as long as they can print to a Diablo- 
compatible printer and access the serial port or card. 
Some old DOS 3.3 programs, like MultiPlan, workjust 
fine— I suspect AfulrifTan accesses the printer slot or 
port without calling on any special firmware tricks. 

Aquich noteconcemingthe WPspreadsheetforthe 
llgs. I'm a spreadsheetjunkie (1 own WsiCaic, Muffiplan, 
fracticaJc, Supercalc 3a, AppleWorks and now WP— 
my favorite is still, believe it or not Muifiplan, although 
SuperCalc has the best business-type graph- 
ics I've ever seen on an Apple). VIP is extensive and 
could give Supercafcand AppleWorks a run except for 
two problems first, the output to printers is extremely 
limited. You can only choose to print to an ImageWriter 
or Epson printer, and then only through slots 1 or 2 
(no LaserWriter, AppleTalk, pen-plotter or other printer 
support— not even the trusty Apple DMP1). Second, if 
you try to print to a non-recognized device, or if you try 
something else the program doesn't recognize, the 
whole system crashes, with total loss of data. Talk 
about being careful! 

In November 1986 (page 2.79) you had a letter 
asking how to convert flies from Multiplan into 
something that could be used by SuperCalc I have 
written a program that will convert a Microsoft SYLK 
file into the more common DIP file, which SuperCalc 
can read. SYLK files and DIP files can only be used to 
transfer data, not form ulas. I'd be happy to let anyone 



who sends me a disk and return postage have a copy 
of the program, 

Finally, how do you get an Applesoft program to run 
under ProDOS 16? How m uch memory can I access — 
am I still limited to 48K minus ProDOS? 

Steven R. White, M.D. 
411 rt Kensington Ave. 
Lagrange Park, 1L 60525 

Anyone using a LaserWriter, and especially those 
using one u>ff ft an Apple //, should read Don Lancas- 
ter's column fn Computer Shopper religiously 
($21/yr. P.O. Box F, TitusMe, PL 32781}. Don has 
reprints of past columns for sale, as well as all kinds 
of Apple Writer goodies for making me LaserWriter 
do mings that Macintosh programs find impossible. 
And he gives out free samples. (Don Lancaster, 
Synergetics, Box 809, Thatcher, AZ 85552 602-428- 
4073). You might also like to took into the National 
Postscript Bulletin Board at 409-244-4704 (300/ 
1200 8til). 

Documentation on AppleTalk as it exists on the llgs 
is non-existent as far as we know. The beta, draft of 
the Apple llgs Firmware Reference Manual docu- 
ments all the other stuff that appears to be connected 
to Itgs slots, but doesn't breathe a word about 
AppleTalk. 

Applesoft runs under ProDOS 8 (with BASIC 
. SYSTEM), never ProDOS 16. Applesoft is structurally 
limited to. and ideally suited for. a 48K program/ 
variable space. Apple has no plans to modify it for 
the larger memory available on the ligs or for 
ProDOS 16. / think they've made the right decision. 
By refusing to make any modification to Applesoft, 
Apple retains complete compatibility between older 
programs and new machines. Applesoft remains a 
universal language, Why can't we agree that any 
language that takes adtantage of the eight-megabyte 
memory space auailable on the llgs should be. 
written from scratch and not be based on a 10-uear- 
old language that uses line numbers and two- 
character variable names? 

ImageWriter II cleaning 

How do 1 remove and clean my ImageWriter 11 

P rinthead? Donald Bock 

Hudson, Fla. 

tlmmm...the ImageWriter 11 Owner's Manual 

doesn't say in its section on maintenance/pages 63- 
66). 

Page 28 of the imagewriter User's Manual (for 
the original Imagewriter) has the essential procedure, 
except that the mechanism that locks down the print 
head is different on the ImageWriter H. 

Pbst, make sure the printer Is turned off. Remove 
the ribbon. As you look at the Ws print mechanism 
from the front uoulf see a white plastic latch along 
the right side of the printhead that clamps it down. 
Gently push this latch toward the power-button side 
of the printer to clear the printhead and jiggle the 
printhead straight upward. If you are right-handed, 
you may find it easier to do this while standing 
behind the machine. Be careful not to let the head hit 
anything as it comes loose, ffte only cleaning 
procedure mentioned is to "wipe" the type head 
gently with a soft brush to dean away loose debris 
left by the ribbon or paper. Then carefully replace the 
head, reversing the above procedure. 

Print heads are delicate and are not cheap; If you 
nave any doubts aboutsafehj removing and cleaning 
yours let a tecn/iictan do it for you. 



Super hi-res converter 

1 do a lot of work in graphics. Traditionally this has 
involved a lot of hi-res and double hi-res files on my 
lie 1 used Dazzle Draw and was happy. But not any 
more. Mow I'm the proud owner of an Apple llgs, and I 
find myself with bushels full of Dazzle Draw format 
double-high and MousePaint format standard-high 
files that I'd like to convert to Super-320 mode, so 
that ! can modify and resave them as Deluxe Paint 
pictures. Do you know of any utility that can do this, or 
of a simple machine code modification I could make 
to my old files to update them? It seems a waste to 
abandon all that old work, and redrawing it would 
take years. " 

James Waschuk 
Saskatoon, SK 

According to the July 1987 issue of Call -A.P.F.L.E. 
(page 57), such a program is available in DL4 (Data 
Library 4) of the download section of MAUQ on 
Compuserve. The program's name is StiRConuert 
and it conuerts a number of fupes of graphics 
formats to Super ffi-res format including Apple // 
single and double hi-res graphics, and Macintosh 
and Atari ST graphics. 

AppleWorks as copy machine 

How about a patch for AppleWorks that would allow 
more than nine copies of something to be printed? 

David L. Smith 
Middlesboro,Ky. 

Beagle Bros/Software Touch AppleWorks guru 
Alan Bird provided us with the following: 

Patch to change tha n&xlmx, number of copies to 255 
[AppleWorks 2.8 onluj 

POrtt 768,255 

BSRVE SEG.Kl.Hae.Ll,H7S8,fl3EB74 ; for HP 

8SBVE 5EG.Hl,HW,U,A76B,miB3 ; for DB 

BSflVt SEG.ni.TSW.Ll,S76B,B65B9S ; far 55 

for other uersions of Apple Works, Alan suggested 
searching the SEQ.M1 file for the byte sequence "A9 
09 20 35 DO" and replacing the 09 with a larger 
value. Dennis looked at AppleWorks 12 and 13 and 
discovered the actual sequence you have to look for 
in SEO. Ml is "A9 09 20 32 DO". This sequence occurs 
fourlimes: change the first three (as Alan did for 2.01: 

Equivalent 8 parameters for Applellgrks L.2 and 1.3: 

V 1.2 V 1,3 

930015 B34253 
B9151 BS1S1 
BG7095 B67332 

After the patch, you can enter any value from 1 to 
255 copies directly. 

Wire loose inside FILER 

I've run into the same problem so many times 1 
don't understand why I've never seen it commented 
in Open-Apple. I usually cannot copy a disk onto a 
new unused dish with FILER. Until something is 
written on the new disk I get a MO DEVICE COJWCTED 
error, If the disk is first formatted with FILER there is 
no problem, but then time is wasted re-formatting at 
the start of the copy. 

Even a DOS 3.Mormatted disk is acceptable as a 
copy target but not a clean one, Why is this? A related 
problem is that quite often AppleWorks L2 and 13 
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will refuse to format a clean disk, with the same error 
message Are they too polite to defile a virgin, or 
what? 

Phil Albro 

CarytlG 

/ have a dim recollection from the early days of 
PmDOS o/ this problem. The reason no one talks 
about it is that no one uses FILER anymore. Copy II 
rtus ($39.95, Central Point Software. 9700 SW 
Capitol Highway, SuUe 100, Portland, OR 97219, 
503/244-5782) is a reasonable ailemafiue that does 
most of what FILER and CONVERT together can do, 
and more, and better. 

Another alternative is den flredon 's ProSfX pack- 
age, which has been recommended here many 
times in the past ($40 from flredon at521 State Road, 
Princeton, 0)08540). It can't convert D0S3.3 files to 
Pro DOS, but it includes all other disk utilities most 
people can imagine, plus a few more you'd never 
think of. (Such as a scheduler that will run programs 
for you, unattended, at the times you select. Early 
purchasers of ProSEL may be missing the scheduler 
and a few other updates to the package. The latest 
PrcSELversimisalways$5forpredouspurchasers, 
directly from Bredon) 

For AppleWorks, try changing to a different disk 
drive for formatting. That seems to work sometimes. 
Otherwise, it's wise to keep a few pre-formatted 
disks around for emergencies. 
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Free help 

Concerning August's letter about loading non-TXT 
files into the ApplelrVbrks word processor module 
("Another use for AppleWorks," page 3.55)— in a 
perverse twist back in July I used this capability to 
load Free Writer, Paul Ltitus' public domain word 
processor, into AppleWorks. I used the OA-Delete 
function to wipe out everything but the help screens 
so 1 could print a hardcopy. 

Clark Stiles 
Grand Rapids, Mich. 

Just don't use this technique to cheat on adventure 
games. 

More on OctoRAM 

[ reviewed the MDIdeas OctoRAM board mentioned 
by Doug McClure (August page 3.51). Look for my 
reviewin the fall issue of Apple II Buyers Guide. There. 
are eight SIMM sockets on the board, You can put in 
either 256K or 1 megabyte SIMMs, but you can't mix 
them. Consequently, if you purchase a 1 meg board 
with four 256K SIMMs (the way MDIdeas ships it), you 
can upgrade the board to two megabytes. If you want 
to go higher, you have to get 1 meg SIMMs, and sell 
your old SIMMs or let them gather dust in your junk 
box. At the present the SIMMs are more expensive 
than an equivalent number of standard memory 
chips, making the OctoRAM somewhat more expensive 
to expand and operate, nevertheless, Ifs the only Dgs 
memory board which can be expanded to 8 Mbytes 
on its main board. 

The ESP ROM board is an extra cost option, but it 
really isn't ROM. It is a piggyback board with 64K of 
static RAM. The board includes a rechargeable battery 
that powers the RAM while the power is off. Extra RAM 
packs are available which expand the ESP board up 
from its standard 128K capacity up to 512K. You can 
set the Ilgs's control panel to boot the ESP board on 
start up or you can access it like any other ProDOS 
drive. Under normal circumstances, the static RAM 
takes very little power and with the rechargeable 
battery pack will last several years before losing data. 
The ROMdlsk is a good idea, and the static RAM with 
battery backup makes it fairly easy to use. The 
disadvantage to static RAM is that ifs extremely 
expensive and sensitive to static electricity. There's 
one major feature on the ESP that I don't like -it 
attaches to the front of the OctoRAM board and 
blocks slots 6 and 7 in your Hgs, the most important 
slots. 

Philip Chien 
fZarthriews 
Tltusville,Fla. 

A tip from subscriber Peter flaum— If you buy an 
OctoRAM and have friends with Macintoshes, pay 
attention to see if they upgrade their Macs to 1 meg 
SIMMs (which they must do to get more than 1 
megabyte of RAM). If they do. you'll have found a 
cheap source of 256K SIMMs, eight of which (2 
megabytes iDortftJ will fit in the OctoRAM. 

The Universal Apple 

1 have lived in Germany for ova ten years and was a 
manager of a local computer store for several years. 
We sold Apple, IBM, Osborne, Tandy, Wang, Nixdorf, 
and a few other brands. In regard to the letter 
"International Answers" In your August issue (page 
3.53), let me assure you that there is no problem 
using any Apple hardware in Europe and there is 



seldom a problem even with combinations of U.S. 
and European Apple hardware. 

I have two Apple lie computers, a Qerman version 1 
purchased less than one month after Apple introduced 
computers in Germany, and a standard American 
version. The Qerman machine was purchased with 
German-version monitor, BOcoiumn card, and Apple 
DMP printer. The U.S. version was purchased with a 
U.S. monitor, text card, and ImageWriter. The VS. 
version has worked perfectly in Germany for over two 
years on a step-down transformer. 

I have added numerous items to each computer as 
the years have gone by, including mice, new drives, an 
RGB monitor, numeric keypad, graphics tablet, daisy- 
wheel printers, and a long list of other items. They all 
work just fine no matter which version they are 
hooked into, with the single exception of the U.S. 
numeric keypad — ifs cord is too short for the European 
Apple II, which has the keypad connector located a 
little further toward the front of the motherboard And 
I am happy to say that 1 have not experienced arty of 
the screen flicker or w-eaving, caused by using a 60 
HertzAppleina50 Hertz country, that you mentioned. 
I also know several other people using this type of 
setup and have heard no complaints. 

I don't recommend this for IBM users though. The 
U.S. version IBM monitor, when used on 50 Hz with a 
transformer, would wave and weave so much that my 
customers would get seasick and turn green. That 
made it real easy to sell Apples-one look at those 
IBM monitors and anything else would look great 

Here are afew other necessary details; travellers will 
need a 300 watt transformer to correct the voltage to 
what Is needed for their system (U.S. systems need 
110-120 volts, European systems need 220 volts). A 
transformer of this size wiil power the computer, a 
monitor, and two printers with room to spare. Remem- 
ber to bring a multi-outlet dropcord from your native 
country since most transformers only have one or 
two outlets and this makes it very difficult to plug in 
four or five items. 

Cards that plug into slot 3 will not work in European 
Apples since the auxiliary slot is located in front of 
this slot and therefore any cards plugged Into the 
auxiliary slot will cover slot 3. 1 have yet to find any 
software that will not run on either version computer. 
Graphics programs, utility programs, word processors, 
games, and even copy-protected stuff seem to run 
just fine (who cares). 

Leave the war games at home though. Wfest Germany 
and several other European countries have banned 
many of these games. Some of the programs Include 
F-15 Strike Eagle and a few other air simulators (not 
SubLogic), several submarine simulators, Rambo 
programs, karate programs, and some other programs 
that in their view glorify war or violence. Theoretically, 
this applies to anyone bringing these games into the 
country also. I say theoretically since nobody has 
been arrested doing so yet 

And finally, getting your computer repaired is not a 
problem. The service 1 have gotten In Europe has 
been excellent However, the U.S. warranty is not valid 
outside the US. 

Dwight Stewart 
Leimen, West Germany 

One item you don't mention thai can't be mixed 
and matched is the normal composite monitor. 
Composifesirjnals use different standards in different 
countries, so computers and monitors should moue 
around the world as matched sets. We have a letter 
from a subscriber in Kuwait who mixed the two and 
"smelted money burning." 



